home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 2 / BBS in a box - Trilogy II.iso / Files / Newton / Util / Strainer 0.8 / Strainer 0.8 READ ME FIRST next >
Encoding:
Text File  |  1993-11-08  |  6.1 KB  |  147 lines  |  [TEXT/ttxt]
  1. Strainer 0.8 by Paul R. Potts 11/8/93 11:25 a.m.
  2.  
  3. description for online services:
  4.  
  5. Strainer 0.8 is the latest release of the Strainer utility, adding
  6. several new features. Strainer is designed to let you easily
  7. mark and remove entries from your Newton's storage. This can
  8. help you to get around a bug in the Datebook which makes it
  9. difficult to delete certain entries, or to remove outdated entries
  10. in order to keep as much memory free as possible. 
  11.  
  12. New features in version 0.8:
  13. - You can now mark entries in multiple soups and strain them
  14. all at once.
  15. - I now handle straining of items on storage cards, if present.
  16. - Strainer now has dialogs to ask you what you want to do if
  17. you close the app before straining out the entries you have
  18. marked.
  19. - You can browse and mark entries in the to-do list and Names
  20. - I have fixed a bug in 0.7 that caused errors when trying to
  21. browse soups and no storage card was present.
  22.  
  23. contact: potts@oit.itd.umich.edu, Compuserve: 71561,3362
  24.  
  25. -----------------------------------------------------------
  26.  
  27. The first version of Strainer that I released (0.3) was completed 
  28. and sent to the net on my birthday, 9-26. I was happy to celebrate
  29. my 26th birthday by sending my first completed Newton application 
  30. into the world. I hope to be able to provide many more useful
  31. and interesting programs in the future.
  32.  
  33. Strainer is a utility that allows the user to browse through three
  34. Newton system soups, called Calendar, Calendar Notes, and Repeat
  35. Meetings. They can see old, obsolete, or incorrect entries, mark
  36. them for deletion, and delete them. Strainer is a little easier
  37. to use than walking around trying to delete everthing in the datebook,
  38. and it can also be used to get rid of entries in the datebook which
  39. can't be removed due to a few bugs in the Calendar. (Yes, PIE is
  40. aware of these bugs and they will be fixed in a future release).
  41. Users might want to use Strainer as a means of keeping as much
  42. memory free as possible; old datebook entries take up room in 
  43. memory, so it makes sense to delete them if you really aren't going
  44. to be needing them any more.
  45.  
  46. Strainer is written using the Newton Tool Kit, which I got at the
  47. Boston MacWorld Newton launch. I'm very new to Newton programming,
  48. like most developers, and so I'm very aware that, although strainer
  49. seems to work, there still may be lurking bugs. Also, I know that
  50. my NewtonScript code is very inefficient; in particular, I'm using
  51. a very inefficient search method in the browser. I have plans to
  52. speed this up greatly in the future. (It isn't your Newton that is 
  53. so slow, it's my code). In a future release, I hope to have the code
  54. cleaned up and looking nice and to distribute the source code as
  55. an example for other Newton programmers who are trying to work with
  56. soups.
  57.  
  58. VERSION INFORMATION
  59.  
  60. Version 0.3:
  61.  
  62. First release.
  63.  
  64. Version 0.4:
  65.  
  66. - actually included something in the READ ME FIRST file; in the
  67. 0.4, it went out blank because of a dumb mistake on my part.
  68.  
  69. - fixed weird, hard-to-pin-down bug where checked items were
  70. becoming unchecked after walking back through a number of them.
  71. (this could result in the user being unable to change their minds
  72. and uncheck an item). The reason the bug was hard to find is that
  73. it was actually two bugs. When I fixed the first bug, the second
  74. bug was still active, making me think that my fix hadn't helped.
  75. The opposite thing happened when I fixed the second bug.
  76.  
  77. - my views no longer float, so you can now bring up another window
  78. on top of them.
  79.  
  80. - made some cosmetic improvements.
  81.  
  82. Version 0.5 (not released):
  83.  
  84. Made it possible to select items in multiple soups for straining. 
  85.  
  86. Added a test so that if we close Strainer with items selected, a dialog 
  87. comes up asking you if you want to delete the items before closing or forget
  88. their marked-for-deletion status. Cleaned up organization of code a bit.
  89.  
  90. version 0.6 (not released):
  91.  
  92. Added support for straining the to-do list soups.
  93.  
  94. Cleaned up the code a lot; reduced app size by removing redundant functions;
  95. now using simpler path expressions.
  96.  
  97. version 0.7:
  98.  
  99. I now use Union Soups so if you have a card in the slot with items on it,
  100. you can browse and delete those items along with ones on the internal store.
  101.  
  102. version 0.8:
  103.  
  104. Fixed a bug which caused an "array out of bound" (-48205) if you tried to
  105. browse with no memory card installed. Apparently most of the people
  106. using Strainer had cards installed, but I did get one report of this problem
  107. which helped me fix it. 
  108.  
  109. Rebuilt with NTK version 1.0b6, which is much nicer to use (speed of builds
  110. has been improved a great deal).
  111.  
  112. NOTES ON USING STRAINER:
  113.  
  114. - I do support union soups, but I'm not yet doing extensive checking,
  115. so there are some things that might cause problems: for example, don't
  116. yank out a card if you're browsing items on it; if you try to strain out
  117. items on a card that is write-protected, you'll probably get an error,
  118. since I don't check for that yet. I'll try to handle all the obvious 
  119. conditions in a future release.
  120.  
  121. - Close the datebook before starting Strainer; otherwise, if you
  122. strain out entries that are visible in the datebook, the datebook
  123. won't update its display until you close it an re-open it (technical
  124. reason: the datebook doesn't respond to the soupChanged message, so
  125. I don't bother to notify it).
  126.  
  127. - If you find ink entries in your calendar soup, they aren't
  128. supposed to be there; remove them. Strainer will say <this
  129. entry is ink>. These entries are apparently in the soup because
  130. of a known bug in the Calendar.
  131.  
  132. Things remaining to fix:
  133.  
  134. I don't know of any real bugs remaining. There are a number of missing
  135. features:
  136.  
  137. - I want to support faster browsing and deleting. Right now, I'm using a
  138. soup to keep track of marked entries; it would be faster to use and
  139. array, so I'll probably do this in the future. Also, my method of searching
  140. for marked entries is extremely inefficient. I'll speed this up in a future
  141. release.
  142.  
  143. - Some of the features I'm thinking of adding: a cleaner interface, a method 
  144. of seeing how many entries are in the soup and how far through them you are,
  145. and an Overview mode.  However, I also want Strainer to remain a small
  146. application, which means not going overboard on features. If there's a 
  147. particular change or feature you want to see, please let me know.